home *** CD-ROM | disk | FTP | other *** search
/ Steal This CD / steal_this_cd.iso / Chapter 07 - Where the Hackers Are / virc200.exe / {app} / ViRC2.chm / func / messagedlg.txt < prev    next >
Text File  |  2002-07-30  |  1KB  |  60 lines
  1. <p class=syntax>Syntax:<br>
  2. MessageDlg <var>options</var> <var>prompt</var><br>
  3. $MessageDlg(<var>options</var> <var>prompt</var>)</p>
  4.  
  5. <p>Displays <var>prompt</var> in a message dialog box, with an icon and a choice
  6. of buttons. The icon and buttons are controlled by <var>options</var>, which is
  7. the sum of the appropriate numbers from this list:</p>
  8.  
  9. <ul>
  10. <li>Buttons shown:
  11.   <ul>
  12.   <li>OK = 0
  13.   <li>OK, Cancel = 1
  14.   <li>Abort, Retry, Ignore = 2
  15.   <li>Yes, No, Cancel = 3
  16.   <li>Yes, No = 4
  17.   <li>Retry, Cancel = 5
  18.   </ul>
  19. <li>Icon shown:
  20.   <ul>
  21.   <li>No icon = 0
  22.   <li>STOP icon = 16
  23.   <li>Question mark icon = 32
  24.   <li>Exclamation point icon = 48
  25.   <li>Information icon = 64
  26.   </ul>
  27. <li>Default button:
  28.   <ul>
  29.   <li>First button is default = 0
  30.   <li>Second button is default = 256
  31.   <li>Third button is default = 512
  32.   </ul>
  33. </ul>
  34.  
  35. <p>If MessageDlg is called as a function, the return value depends on the
  36. button selected by the user:</p>
  37.  
  38. <ul>
  39. <li>OK = 1
  40. <li>Cancel = 2
  41. <li>Abort = 3
  42. <li>Retry = 4
  43. <li>Ignore = 5
  44. <li>Yes = 6
  45. <li>No = 7
  46. </ul>
  47.  
  48. <pre class=example>Example:
  49. // show Yes, No, Cancel with question icon
  50. @l $x = $MessageDlg(35 Do you want to save your changes before quitting?)
  51. switch $x
  52.   case 6:
  53.     // yes - save changes
  54.   case 7:
  55.     // no - discard changes
  56.   case 2:
  57.     // cancel - don't quit
  58. endswitch</pre>
  59.  
  60. <p class=seealso>See also: <a href="../cmd/messagebox.htm">MessageBox</a></p>